PATHMac OS 8 and 9 Developer Documentation > Human Interface Toolbox > Appearance Manager >

Programming With the Appearance Manager

SetThemeCursor

Sets the cursor to a version of the specified cursor type that is consistent with the current theme.

pascal OSStatus SetThemeCursor (
                     ThemeCursor inCursor);
inCursor
A value of type ThemeCursor . Pass a constant specifying the type of cursor to set; see Theme Cursor Constants for a description of possible values.
function result
A result code; see Result Codes .
DISCUSSION

Appearance Manager 1.1 introduces cursors that can change appearance with a theme change. In order to be theme-compliant, your program should use these theme-specific cursors whenever possible, instead of the classic black-and-white cursors. Because these are color cursors, they currently cannot be set from interrupt time.

Your application should call the SetThemeCursor function to ensure that its cursors are theme-compliant, rather than the QuickDraw cursor utilities functions SetCursor or SetCCursor . If you wish an animatable cursor to be theme-compliant, call the function SetAnimatedThemeCursor .

SPECIAL CONSIDERATIONS

Do not call SetThemeCursor at interrupt time.

VERSION NOTES

Available with Appearance Manager 1.1 and later.

© 1999 Apple Computer, Inc. – (Last Updated 29 April 99)